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The 65816 continues to make news. We hear of at least two 
major books on 65816 Assembly Language, which should be in 
print soon. We also hear that sales of the chip are taking 
off, with some firms ordering multiplied thousands. Although 
we have yet to SEE one, we keep hearing reports of plug-in 
boards for Apples that contain a 65816 and lots of RAM: 
ComLog, MicroMagic, Checkmate Technology, and others. 


Meanwhile, we contemplate the future advantages to just 
enhancing existing Apples with 65802's and big RAM boards. 
Applied Engineering or Checkmate will be delighted to stuff 
512K additional RAM into your //c. You can add five times that 
much to your //e with AE's latest version of RAMWorks. Apple's 
forthcoming Slinky card will add up to a megabyte to any II, II 
Plus, or //e with a spare slot (1-7). Call APPLE's latest 
magazine offers the BIG BOARD for slot 0-7 use, one megabyte 
addressable either in Slinky fashion or with “standard" 
DOOO-FFFF mapping, for only $599. If you hurry, they have a 
special (even lower) price good until Sept 30th. 


6800 Cross Assembler for ProDOS 


The S-C 6800 Macro Cross Assembler is now also available in a 
ProDOS version. This is the Version 2.0 level Cross Assembler, 
including the additional opcodes of the Motorola 6801 and 
Hitachi 6301 microprocessors. Either the DOS or the ProDOS 
Version 2.0 Cross Assembler is $50; if you already have one you 
can add the other for only $20. 


//c + Z-RAM = 576K Printer Buffer......++e+ee.eeeDavid C. Johnson 
Applied Engineering 


What has 640K of memory and is as cute as a button? My Apple 
//cl! It didn't come with all that memory, “only" 128K of it. 
Before I even powered it up for the first time, I installed a 
512K Z-RAM. Ready to take on Blue's 640K machine? Maybe. 


I've had quite a few Apple Computers, my first had Integer ROMs 
and a serial number in the thirty one thousands, and my current 
workhorse is an Apple //e with the works. So why a //c? Well, 
for one it's cute, and secondly its firmware was written by 
Ernie Beernink and Rich Williams, the same guys that wrote the 
//e Enhanced ROMS and Extended Debugging Monitor. These guys 
write slick code. Finally, I can type control-reset with one 
hand. 


Well, what to do after getting it home? I tried my mouse out 
on it, but moved it back to the //e. My paddles and joysticks 
all have 16-pin plugs, so I couldn't use them. I don't have an 
RGB interface for the //c yet, so the color monitor has to stay 
put- That leaves my Imagewriter printer to play with. 


Having two computers and only one printer is an old problem. 
One usually solved with a rotary switch. I figured that I 
could do a little better. What I did is connect the 
Imagewriter to the //c's Printer port, and the //e's Super 
Serial Card (SSC) to the //c's Modem port. I then wrote the 
program that follows this article. It implements a 576K butfer 
for the //e, in the //c. Now I can use the printer from the 
//c just by typing pr#l. When I want to print from the //e, I 
just boot a disk on the //c, then type pr#l on the //e. 
However, the printing, for the //e, goes MUCH faster. I've 
setup the link between the //e and the //c to transmit at 19200 
baud! Assembling a listing of the buffering program takes 
about 7 seconds (and half of that is writing the target file)! 


The SSC is in slot l. it is configured as follows: 


SWl: off off off off off on on 
SW2: on off off on on off off 
The jumper block is installed pointing towards modem 


The Imagewriter's swiches are set: 


SW1: open open open open closed closed open open 
SW2: closed closed open open. 


The pieces are connected with two DIN 5-Pin(m) to DB-25(m) 
cables, Apple Model Number: A9C0308 (4-2, 2-3, 1-6, 3-7, and 
5-20). The cable from the //e to the //c is plugged into a //c 
System Clock which in turn is plugged into the Modem Port. 


The program should work with most any serial printer, and 
serial card, however, if the serial card cannot “eliminate the 
modem", you will need a modem-eliminator cable extension, or 
will have to reverse pins 2 and 3 and pins 6 and 20 of the 
DB-25 connector. The Apple cable I used cannot be modified. 
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S-C Macro Assembler Version 2.0......DOS $100, ProDOS $100, both for $120 
ProDOS Upgrade Kit for Version 2.0 DOS OWNErS...ccccccccccccccccseccee $30 
Version 2.0 opyecee Kit for 1.0/1-.1/1.2 ownerS...ccccccccccccvcccecseseeS2l 
Full Screen Editor for S-C Macro (with complete source code) ........+«$49 
S-C Cross Reference Utility......without source code $20, with source $50 
RAK-Ware DIESAGM io io oS6 6:86:66 6S WOW OOS SES 66-45 ENG 45 Eww OU 
Source Code for DISASM oe. 6.6 seh S600 6600 OS 6 wha e604 6 és co Nese ec Bdditional $30 
S-C Word Processor (with complete source COde) ..cccccccccccccccseccees$D0 
DP18 Source and eg (i Terre ere rr ere ee re ee ee ee ee ee ee ee ee ee ee ee ee 
Double Precision Floating Point for Applesoft (with source code)......$50 
“Bag of Tricks", Worth & Lechner, with diskette.....ccccccee ($39.95) $36 
MacASM ~-- Macro Assembler for MacIntosh (Mainstay).......--($150.00) $100 
S-C Documentor (complete commented source code of Applesoft ROMs).....$50 
Source Code of //e CX & FB ROMS on GiBK 666s 64 00086 644600666000 6000060515 
Cross Assemblers for owners of S-C Macro Assembler.....$32.50 to $50 each 


(Available: 6800/1/2, 6301, 6805, 6809, 68000, 2-80, z-8, 8048, 8051, 
8085, 1802/4/5, PDP-11. GI1650/70, others) 


AAL Quarterly DiBkS..c.ccccrcccccccecccscceceeeeach $15, or any four for $45 
Jan-Mar Apr-Jun Jul-Sep Oct-Dec 
1 


Each disk contains 1980 - - - 

the source code from 1981 2 3 4 5 

three issues of AAL, 1982 6 7 8 9 

saving you lots of 1983 10 11 12 13 

typing and testing. 1984 14 15 16 17 
1985 18 19 


(All source code is formatted for S-C Macro Assembler- Other assemblers 
require some effort to convert file type and edit directives.) 


Verbatim Diskettes (with hub ringS)...cccccccecseee package Of 20 for $32 
Vinyl disk pages, 6"x8.5", hold two disks each..cccccccccecceeee 10 for $6 
Diskette Mailing Protectors (hold 1 or 2 disSkS).....ecececeeeee 40 Cents each 

(Cardboard folders designed to fit 6"X9" Envelopes.) or $25 per 100 
Envelopes for Diskette MailerS..cccccscccccccvcccscccccccccee 6 Cents each 


65802 Microprocessor (Western Design Center) ..c.ccccccccccccceee (995) $50 
quikLoader EPROM System (SCRG) sesses des ess cea sees wese wae ewnas (5179) $170 
PROmGRAMER (SCRG) 66065 Gio 6 6 6600565 O66 054946 0S 0646 eS eewews (5149.50) $140 
Switch-a-Slot (SCRG) ssc ceweee es eevee ee see eves eeewedseevewweses ($190) $175 
Extend-a-Slot (SCRG) 6. 640 ose 64 OAS Oo wh wee We oe we wee ew CeSo) $32 


“Apple ProDOS: Advanced Features for programmers“, Little..($17.95) $17 
"Inside the Apple //eo", Litt lei.is4 dbwe ede ewan Kite eww nsec ($19.95) $18 
“Inside the Apple //e", Little... cccccccccrccccccccvcccccccses (919.95) $18 
“Apple II+/IIe Troubleshooting & Repair Guide", Brenner.....($19.95) $18 
"Apple J{ Circuit Description", Gayler..cccccccccccccccccees (922.95) $21 
“Understanding the Apple II", Sather...ccccccccccescccccecce (922.99) $21 
"Understanding the Apple //e", Sather.c.cccccsecccccccccccese ($24.95) $23 
"Enhancing Your Apple II, vol. 1", LancasSter..ccccccccccceee ($15.99) $15 
“Enhancing Your Apple II, vol. 2", Lancaster.ccccccccscccece(Sl7.95) $17 
"Assembly Cookbook for the Apple II/IIe“, Lancaster.......-.($21.95) $20 
"Beneath Apple DOS", Worth & LeEChner....cccccccccccccvcccvecee (919.95) $18 
“Beneath Apple ProDOS", Worth & LeChnerecesecccccccccvcccces (919.95) $18 
"6502 Assembly Language Programming", Leventhal....cccccceee ($18.95) $18 
"6502 Subroutines", LEVEN tha Ll iv dos cide ds 664d ww thd Caw es ws ($186.55) $18 
“Real Time Programming -- Neglected Topics", Foster...c.ccccee ($9.95) $9 
“Microcomputer GraphicS", MyerS.ccccccccccccccccccccesccesee(Sl2.99) $12 
“Assem- Language for Applesoft Programmers", Finley & Myers.($16.95) $16 
“Assembly Lines = the Book", WAQNEE be sndaceusseeeeessesewwe ($19.95) $18 
“AppleVisions", Bishop & GrOSSDELGer..ccccccccccccccccscccces ($39.95) $36 


Add $1.50 per book for US shipping. Foreign orders add postage needed. 
Texas residents please add 6 1/8 % sales tax to all orders. 


*** S-C SOFTWARE, P. O. BOX 280300, Dallas, TX 75228 *** 


tae (214) 324-2050 uae 
*** We accept Master Card, VISA and American Express *** 
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While the listing included with this article requires a 512K 
Applied Engineering 2-RAM board, I have also written versions 
that work in a 256K Z-RAM and in a stock Apple //c. More on 
these versions later. The memory on a Z-RAM is implemented as 
additional banks of auxiliary memory. Which of the auxiliary 
banks is the current auxiliary bank is controlled by a new 
hardware location at $C073. The Z-RAM powers-up disabled, that 
is, with the //c's built-in auxiliary bank as the current 
auxiliary bank. The //c powers-up with main memory enabled and 
all auxiliary memory disabled. Once selected as the current 
auxiliary bank, a Z-RAM bank is switched around by all the 
normal soft switches in the same manner as the //c's built-in 
auxiliary bank. A 512K Z-RAM has 8 additional banks and a 256K 
Z-RAM has 4 more. Which additional bank is the current 
auxiliary bank is selected by writing an ODD number between 1 
and $F (inclusive) to the bank register at $C073. The 4 most 
Significant data bits are ignored and any even number (usually 
zero) selects the //c's built-in auxiliary bank. A 256K Z-RAM 
only has bank numbers 3, 7, $B, and SF. To ease the task of 
writing programs that display 80 columns of text or double 
hires graphics, video data is always fetched from the //c's 
banks, even if a Z-RAM bank is the current auxiliary bank. 
Because the Z-RAM plugs into the processor and MMU sockets of 
the //c, and since only one board may be added this way, the 
Z-RAM includes a Z-80 processor. The Z-RAM is also totally 
compatible with the RamWorks board for the //e. 


The //c's serial ports are a lot like Super Serial Cards in 
slots 1 and 2 of a //e. The ports and the SSC both use the 
6551 ACIA (Asynchronous Communications Interface Adapter) and 
the firmware is quite similar. There is one significant 
difference that I found. The SSC tells an external source of 
data to stop transmitting by asserting the Data Terminal Ready 
bit of the ACIA command register (and thus the DTR pin when the 
jumper block is in the terminal position), while the //c's 
ports control the DTR pin with the Request To Send (and 
transmitter control) bits. It's right there on page 254 of The 
Apple //c Reference Manual Volume 1. Compare this to the 
schematic on page 100 of the SSC Manual. 


Because every //c has a 65C02 processor, I can write code using 
the new opcodes and it will work in other peoples' machines. 

Of course if the code will also work in a //e, I can not be 
sure that it will be executed on a 65C02. With the release of 
the //e enhancement kit, this situation should improve. 65802 
opcodes, being new and rare, must be reserved for programs 
intended for use in a very few machines. 


On to the program. The target file is intended to load at 
$2000 in main memory. The code from lines 32 to 73 is executed 
in the $2000 area. This section does all of the setup for what 
is to come. The D and I flags are cleared and set 
respectively, ten soft switches are thrown, the screen is 
Cleared, the remainder of the code is copied into ALL auxiliary 
zero pages and stacks, a text message is written to the screen, 
and the two ACIAs are initialized. The code copy and message 
printing share a loop. Lines 66 and 70 cheat a little. The 
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INCS are assembled and the LDA #s are treated as comments. 
They work because the would-be operands of the LDA #s are one 
greater than the values just loaded by the previous LDA #s. 
The 'A' in line 74 is an open-apple MouseText character. The 
code in aux bank 0 is then entered at label ‘Scan’. 


The routines ‘Write’ and ‘Read’ (lines 79 and 88), handle all 
access to the buffer- In '‘Write', the aux bank is selected, 
the address within that bank is written into the operand of a 
store absolute instruction (the copy in the bank just 
selected), and then the data byte is written. That's a total 
of four bytes of information passed in internal registers. The 
data byte had to be passed in the stack pointer! It couldn't 
have been passed in a memory location because it would have 
been switched out. ‘Read’ is a little simpler, it returns a 
data byte in the Acc. Since I'm using the S-reg for data and 
the aux bank 0 stack page for code, the program doesn't make 
any use of regular stack operations. After re-selecting aux 
bank 0, ‘Write’ and ‘Read' jump back to the code just after the 
jumps that ‘called’ them- Even though the $2000 code copied 
the entire image into every aux bank, only ‘Write’ and 'Read' 
are not used as buffer in the Z-RAM banks. 


Lines 99 to 108 allocate the (zero page!) variables required to 
keep track of the buffer The ‘Receive’ variables indicate 
where the next byte received will be buffered, the ‘Transmit’ 
variables indicate where the next byte to be printed is 
buffered, and the ‘Byte.Counter’ variables keep track of how 
full (or empty) the buffer is. If the byte counter is zero, 
then the 'Transmit' variables are equal to the ‘Receive’ 
variables and the buffer is empty. ‘RTS.Bit' is used to keep 
track of the //c's ‘select’ state. 


Lines 110 to 128 run an indicator at the top-center of the 
screen and check to see if you've pressed a key. If you press 
the space bar, and if the program hasn't asserted the Request 
To (NOT) Send bit (because the buffer is nearly full), the //e 
may be halted. This works like a printer's select button. 


Lines 129 to 207 handle buffering incoming data. If the Modem 
ACIA detects any transmission errors, you will see an 
indication of this at the left end of screen line three. If no 
character has been received, we go check the Printer port. 

When a character has been received, we test if the buffer is 
almost full. If it is, we assert RTS' (another character may 
already be on the way). The byte counter is incremented. If 
the buffer is completely full, we tick the third position of 
screen line one and go check the Printer port. This means that 
the RTS' handshaking isn't working. You will also get overrun 
errors. If we have room for the character, we increment the 
upper left screen position, and load the character from the RxD 
reg into the stack pointer. We then load the 'Receive' 
variables, maybe juggle the address high order nibble for the 
overlapping language card banks, and call ‘Write'. Upon 
return, the 'Receive' variables are advanced through the buffer 
memory, avoiding our program and invalid aux banks. We then 
fall into the Printer port code. 
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Lines 208 to 271 handle printing buffered data as the printer 
can take it. This code is similar to the code for incoming 
data. Fewer things can go wrong, we of course test for an 
empty TxD reg and an empty buffer. We check to see if the 
buffer is somewhat less than almost full, and may release RTS'. 
The byte counter is decremented here. When a character is to 
be printed, we increment the upper right screen position, load 
the 'Transmit' variables, maybe juggle, call 'Read' and stuff 
the character into the TxD reg. Upon return, the 'Transmit' 
variables are advanced (same way), and we loop to ‘Scan’. 
Forever. Reset exits the program. 


The program loops VERY quickly. It has to. At 19200 baud, a 
character is received from the //e every half millisecond and 
at 9600 baud, a character may be printed every millisecond. 

The pair of locations at the top center of the screen, that are 
changed every time around the loop, give a good indication of 
how fast things are happening. The locations in the upper 
corners (my //e is to the left of the //c and the printer is to 
the right) are a good representation of the values of the 
‘Receive’ and 'Transmit' variables. When buffering, the receive 
indicator races ahead while the transmit indicator lags behind, 
but since they are both initialized to blanks and the 
appropriate one is incremented when a character is moved, they 
come to rest displaying the same character when the buffer is 
empty. 


The symbols 'Z.RAM.Banks.Avail', 'Z.RAM.Banks.Used', 
‘IIc.Aux.Bank.Avail' and 'BufLen' (lines 94, 96, 273-274) 
determine the size of the buffer. The ADC immediate operands 
in lines 195 and 259 cause the buffer to advance from bank 0 to 
1 to 3 to 5... to SF. The listing is setup to use a //c's aux 
bank and a 512K Z-RAM. The changes for a 256K Z-RAM are easy: 
change the SAVE and .tf filenames (320K), change the 8 in line 
96 to a 4, change the 9 in line 274 to a 5, and change the ADC 
#1s in lines 195 and 259 to ADC #3s. The changes for operating 
without a Z-RAM are not as simple. I removed all the bank 
stuff, made the byte counter only 16 bits, and combined the 
code copy with the screen clear instead of the message 
printing. It took about 5 minutes. The resulting code just 
fit into the aux zero page! The source code for all three 
versions will be on S-C Software's next quarterly disk, and I 
will send a paper listing of the //c only version to anyone who 
sends a self addressed stamped envelope to me care of Applied 
Engineering. I sometimes use the //c only version even though 
I have a Z-RAM. With the ProDrive disk emulation software, I 
can lock-out bank 0, leaving it available for double hires or a 
64K buffer for my //e. With a 512K Z-RAM, I get a 1024 block 
/RAM volume. 


The program does not use any main memory for the buffer because 
when you have 576K of aux memory, why bother programming for 
“only” another 64K? The //c only version, with 64K of buffer 
memory, is as big or bigger than most buffer boards/boxes. If 
anyone writes a 128K main/aux version of the program I would 
appreciate a copy. 
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NEW DON LANCASTER RELEASES 


Available ONLY from Synergetics. All software open and unlocked. 


ABSOLUTE RESET (IIc/old Ie/new Ife) ...........secee0 $19.50 
Get back in total control. No more hole blasting! Access any part 
of any program at any time for any reason. Passes all diagnostics. 
Invisible till activated. Includes EPROM burner adapter details, 
service listings, and a free bonus book. 


APPLEWRITER™ TOOLKITS (DOS 3.3 or ProDOS)....... $39.50 
EIGHT diskette sides include a complete disassembly script; source 
code capturing; self-prompting glossaries; Diablo microjustify and 
proportional space, patches including NULL, shortline, Grappler, IIc 
detrashing, many others; answers to most help line questions; two 
columns; WPL secrets; space on disk; keyword indexing; multi and 
even-odd headers; bunches more. 


Both TOOLKITS (sixteen disk sides )............ . - $59.50 


APPLEWORKS" DISASSEMBLY SCRIPT............... $49.50 
TEN diskette sides chock full of Applework’s innermost secrets, 
using Don’s unique and powerful "tearing method". Primarily for 
gonzo hackers and definitely NOT for the faint of heart. 
LASERWRITER/APPLEWRITER UTILITIES .......... $39.50 
Two volume package gives you unmatchably superb Ile text and 
graphics. Included are automatic formatters, boxes and fancy 
borders, daisywheel changers, envelope and label routines, 
unbelievably fast formletters, grids and rulers, HIRES converters, 
DC1 patches, demos, justify routines, self-prompting glossaries, 
help screens, a sign shop, outlined text, more. 


AUTOGRAPHED LANCASTER BOOKS: 
Apple Ile Assembly Cookbook 
All About Applewriter Ile 
Enhancing Your Apple II & IIe, (Volume I or II) 
Micro Cookbook (Volume I or II) 
CMOS Cookbook 


Incredible Secret Money Machine 
Complete book and software list 


COMPANION DISKETTES: 


For Enhancing Your Apple II, Volume I 
For Enhancing Your Apple II, Volume II 
For Don Lancaster’s Assembly Cookbook 


SYNERGETICS 


746 First Street 
Box 809-SC VOICE HELPLINE 


Thatcher, AZ, 85552 (602) 428-4073 


Appleworks, Re and ProDOS are registered trademarks of Apple Computer. 


VISA and MASTERCHARGE accepted. Please - no COD, foreign, or purchase orders. 
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Boas ; SAVE Buf .576K 
noe ; Dedicated to Allan B. Calhamer. 
c098- 0005 Printer. ACIA.TxD .eq $C098 w} 
C099- 0006 Printer.ACIA.Status .eq $C099 (r 
CO9A=- pou Printer.ACIA.Command .eq $CO9A (r/w 
CO9B- 0008 Printer.ACIA.Control .eq $C09B (r/w 
COA8— 0009 Modem. ACIA.RxD -eq $COA8 r 
COA9= 0010 Modem. ACIA. Status -eq $COAQ (r 
COAA- 0011 Modem. ACI A.Command -eq $COAA (r/w 
COAB~ 0012 Modem. ACIA.Control -eq $COAB (r/w 
C07 3- 0013 Z.RAM.Bank. Reg -eq $C073 (w) same as RamWorks 
C00 0014 Keyboard -eq $C000 (r 
C001- 0015 Store80 -eq $CO001 (w) on 
C003- 0016 RAMRd -eq $C003 (w) aux 
C005- 0017 RAMWrt -eq $C005 (w) aux 
C009- 0018 AltZP -eq $C009 (w) aux 
CO0C- 0019 Vid4o -eq $CO0OC (w 
COOF- 0020 SetAltChr -eq $COOF (w) w/MouseText 
C010- 0021 Clear.Key.Strobe _eeq $C010 (r 
CO51- 0022 Text -eq $C051 (r 
CO54- 0023 Pagel -eq $CO54 (r) main 
C055—- 0024 Page2 -eq $C055 (r) aux 
CO57T- 0025 Hires -eq $C057 (r) $2000-$3FFF too... 
C08 3- 0026 LCRAM2 -eq $C0383 (r/w; write doesn't 
CO8B- Hees LCRAM1 -eq $CO8B change write enable) 
0029 ’ .op 65C02 
0030 -or $2000 
2000- 0031 otf Bufit576K 
2000- D8 0032 dej CLD rqd (now) 
2001- it 0037 SEI close this can of worms... 
2002=- 83 CO 00 LDA LCRAM2 1x..-switches setup 
2005= AD 51 CO 0035 LDA Text 
2008- AD 54 CO 0036 LDA Pagel 
200B=- AD 57 CO 9036 LDA Hires 
200E- 9C 01 CO 00 STZ Store80 
2011- 9C CO 0039 STZ RAMRd 
2014=- 9C 05 CO 0040 STZ RAMWrt 
201T7= 9C CO 0041 STZ AltZP 
201A- 9C OF CO 0042 STZ SetAltChr 
201D= 9C OC CO 004 STZ Vid40O 
2020— AQ AO 004 LDA #* *® clear 40 column screen 
2022= A2 00 04 LDX #0 
2024—- 9D 00 O4 OOS .1 STA $400,X 
202T=- 9D 00 05 O04 STA 00,X 
202A= 9D 00 06 O04 STA $600,X 
202D- 2p 00 O07 O04 STA $700,X 
2030- 05 INX 
2031=- DO F1 0051 BNE .1 
2033- AO OF 0052 LDY #$0F install Image in aux ZPs/Stacks 
S38. 8C q CO 0053 .2 Y Z. RAM. Bank. Reg 
2038- BD 20 0054 .3 LDA Image, 
203B- 95 00 5gee STA $00.X 
203D=- BD 77 21 00 LDA rr 8 ela 
2040- 9D 00 01 005 STA $100, 
2043- E8 005 INX 
204 DO F2 003 BNE .3 
2046- BY 67 20 0 LDA Msg Y put up a message 
2049- 99 OC 05 0061 STA $50C,Y 
204C- 0062 DEY 
204D- 10 E6 006 BPL .2 
204F- AQ OA 006 LDA #%4000.0.10.1.0 bop ACIAs 
2051—- 8D 9A CO 0065 STA Printer .ACIA.Command 
2054= 1A 0066 ine LDA #%000.0.10.1.1 RTS* lo 
2055- 8D AA CO 006 STA Modem. ACI A. Command 
2058 AQ 1E 006 LDA #20.00.1.1110 9600 baud 
205A- 8D 9B CO 006 STA Printer.ACIA.Control 
205D—- 1A 007 inc LDA #%0-.00.1-1111 19200 baud! 
205E- 8D AB CO 0071 STA Modem. ACIA.Control 
2061= AD A8 CO 0072 LDA Modem. ACIA. RxD 
2064— 4C 2B 00 bare JMP Scan go 2 it 
2067=- 41 0 Msg ~AS ‘A! as in Apple 
2068—- AO AF AF 
206B- E3 AO E2 
206E- F5 E6 E6 
207T1=- E5 F2 AO 
2074= FO ET ED 0075 -AS -" //c buffer pgm" 
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oor rere pane 3p ified by Acc, bank adr lo by X-reg 
spec = 
ees aux? Spe y 4 


8 by sig 4 bank i ort in S-reg| 
0000—- 8D co 00 Rice i Z.RAM.B @ n Ze 
Eg 86 05 0086 ae - Na ; Pas dify STX operand in "this" bank 
eo it 
007 BA BA . 0082 TSX get byte to a usable reg! 
O008- 8E FF FF 0083 .1 STX $FFFF abs adr modified for each write 
pose $6 i3 me ee ue a oo -Reg revert to //c aux bank 
- et 
oo8e 3 aux bank a eget he by Acc, bank adr lo by X-reg, 
008T * bank adr hi by Be id 1 an ES returned in Acc. 
0011- 8D 73 CO 0088 Read STA z. RAM eg Z-RAM 
te 86 19 ety ae : “141 modify LDA operand in "this" bank 
= e + 
0018=- AD FF FF 0091 .1 LDA $FFFF abs adr modified for each read 
00 1E- : B hie ae . ne ean Ree revert to //c aux bank 
=: et 
nee Z.RAM.Banks. Avail .eq #-3 
0095 ; (-3 because JMP R. Ret never executed in Z-RAM) 
FO- 9098 2 4. RAM.used .eq Z.RAM.Banks. Avail #8 
0095 : buffer starts at first available location in //c aux bank 
0021- 7F 0099 heceive.Adr.Lo .da #IIc. Aux. Bank. Avail 
0022= 01 0100 Receive. Adr.Hi eda /IIc. Aux. Bank. Avail 
0023=- 00 0101 Receive.Bank da #300 
0024=— TF 0102 Transmit.Adr.Lo eda #IIc.Aux.Bank. Avail 
002 01 Siok Transmit.Adr.Hi eda /IIc.Aux.Bank. Avail 
0026— 00 01 Transmit .Bank eda #300 
0027= 00 Boe Byte.Counter.Lo eda #3000000 indicates empty 
0028- 00 0100 Byte.Counter.Mid eda #$000000/256 
0029- 00 nab Byte.Counter.Hi eda #$000000/65536 
OO2A- 08 O109 R Bit eda #%000.0.10.0.0 RTS' lo 
002B- AD 54 CO 0110 Scan LDA Paget access main text screen 
Cosi. CE 1 O& Olle Bee ut ee Pees 
0034- AD 55 CO O13 LDA Page2 back to aux 
0037- AD 00 CO 011 LDA Keyboard scan keyboard 
0OO03A=- 10 1E reer BPL Scan.Modem. Port 
oe co ty a sy a space toggles RTS' (DTR2B) to //e 
OOLG- AD AK CO 0116 LDA Modem. ACIA.Command 
0043- 29 08 0119 AND ane: 0.10.0.0 
OO45- DO O4 0120 BNE =>It's ok, you can turn it off... 
OON7=- A5 2A 0121 LDA ats. Bit 
O049- DO OF 0122 BNE Scan.Modem.Port =>don't do it! (yet) 
OONB- AD AA CO Bion 1 LDA Modem. ACI A.Command 
OO4E- 49 O 012 EOR #%000.0.10.0.0 
0050- 8D AA CO 0122 STA Modem. ACIA.Command 
Sse Ge Se Sree RR BORE 1020-0 
0057- 2C 10 CO 0126 2 BIT Clear age Strobe 
0129 Scan.Modem.Port 
pOeD: O68 AQ CO o13t mh Modem. ACIA. Status 
OO5E- 29 07 0132 AND #%0000.0111 error bits mask 
peeoe Hs OA Et BEQ .1 =>error-free operation 
006 3- 54 co EL LDA Pagel access main text screen 
0066- FE FF 04 0136 INC $4FF,X indicate error... 
0069- Ap 55 CO O13] , LDA Page? back to aux 
006D- 29 08 0139 ° AND £40000. 1000 receive data reg full mask 
O06F=- FO 35 0140 BEQ CantRx =>not full 
0071- A5 2 0141 LDA Byte.Counter.Lo received a byte 
0073- Ab 2 0142 LDX Byte.Counter.Mid do we assert RTS' ? 
0075— A4 29 O13 LDY Byte.Counter.Hi 
0077=- C9 91 014 CMP #BufLen-256 
SorB- BO re | o4ke BPE /BufLen-256 etter not @ full-256 
- ufLen- 
OorF= co 08 © -O4ng eer ner nskee eee 
- ufLen- 
0081- DO 0 alee BNE .2 =>buffer not @ full-256 
0083—- AJ 015 LDA #£4000.0.10.0.0 assert RTS’ 
0085—- 1C AA CO 0151 TRB Modem. ACI A.Command 
0088- A5 0152 LDA Byte.Counter.Lo reload it 
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OO8A=- 1A 0133 “2 INC fig next byte count 

OO8B- DO O4 015 BNE .3 

O08D- E8 ree INX 

ls DO 01 we cd 3 

0091~- C9 91 0126 3 CMP #BufLen do we have room for it ? 
0093— DO 13 nite ace paces =>buffer not full 

0095=- EO FD ufLen 

097. R O16) BNE Room =>buffer not full 

608 CO 0 0162 CPY BufLen 

003 - DO 0163 BNE Room =>buffer not full 

O9D=- AD 54 CO 016 LDA Pagel access main text screen 
OOAO=- EE 02 O04 018 INC iB > indicate full 

OA3=- AD 55 CO 01 2 LDA Page2 back to aux 

OO0OA6- 80 51 aa CantRx BRA Cant.Receive =>buffer is full! 

OOA8=- 85 | 0165 Room STA Byte.Counter.Lo 

OOAA- 86 2 0169 STX Byte.Counter .Mid 

OOAC- 84 29 017 STY Byte.Counter .Hi 
OOAE- AD 54 CO 0171 LDA Pagel access main text screen 
OQB1=- EE 00 04 0172 INC $400 show we received a byte 
OOBY- AD 55 CO ne LDA Page2 back to aux 

OOB7- AE AB CO 01 LDX Modem. ACTA. 

OOBA- 9A Otte TXS pass it in S-reg 

OOBBe AN 32 Of (DY Receive. adr. Ha 

OOBD-=- eceive.Adr. 

OOBF- 2C 83 CO O176 BIT LCRAM2 normally use LC bank 2 
goes 26 FO ote AND #$F0 

aoCTe C2 go ates Hal 4 EO 00 if adr is in $CXXX range 

ee oe B CO O83 BIT LCRAM1 use LC bank 1 

iss 09 DO O18? _ /$D000 
SSPE 12 $8 oo Sid <7 SBA fecgtve-Bant 

- rite 

OOD5- E6 21 0189 W.Ret INC Receive.Adr.Lo fig next receive adr 
OOD7=- DO 20 019 BNE Scan. Printer.Port 
OOD9- E6 22 0191 INC Receive. Adr.Hi 

OODB- DO 1C 0192 BNE Scan.Printer.Port 

SSBP- 83 5] Big gvedve Bank 
geet 63 ut O12 me flo clear carry if 0, else set it 
OOE5- 90 08 01 BCC . =>entering/still in Z-RAM 
OOET= AJ 00 6195 ; LDA #$00 wrap to //c bank 0 

OOE9=- A2 TF 0199 LDX #IIc.Aux.Bank.Avail 

ROEDL ao ft a aH (tO; AUR nanhoayess 

OOEF- A2 1E 0202 .1 LDX #Z.RAM.Banks. Avail 

OOF 1- AO 00 020 LDY /Z.RAM.Banks. Avail 

OOF3=- 85 23 0204 .2 STA Receive. Bank 

OOF5- 86 21 0205 STX Receive. Adr.Lo 

OOFT—- 84 22 02 STY Receive.Adr.Hi 

0207 Cant. Receive 
02038 Scan. Printer.Port 

poche A? 0 0209 LDA #%0011.0000 make transmit data reg empty and 
OOFB- 2 3g CO 0210 AND Printer.ACIA.Status Data Carrier Detect mask 
OOFE- C9 10 0211 CMP #%0001.0000 test empey and DCD' lo 
0100- DO 7A 0212 BNE Cant.Transmit =>not ane y or not ready 
0102= A5 2 021 LDA Byte.Counter.Lo printer can take another byte, 
0104- 05 2 021 ORA Byte.Counter.Mid do we have one ? 
0106- 05 29 0215 ORA Byte.Counter.Hi 

0108= FO 72 0216 BEQ Cant.Transmit =>buffer is ag) A 
O10A=- A a 021 LDA Byte.Counter.Lo do we release RTS‘ ? 
010C- A6 2 021 LDX Byte.Counter.Mid 

010E- AX 29 0219 LDY rp Aa lochs’) st Sa 

0110- C9 91 0220 CMP #BufLen=-2048 

0112- DO OD 0221 BNE .1 =>buffer not @ full-2048 
0114= EO F5 0222 CPX /BufLen-2048 

Ug DO O 022 aoe ai # 2048 =>buffer not @ full-2048 
0118=- CO 0 022 ufLen- 

Sits 0 S937 its nay S>baffor not @ fuli-20ne 
O11E= OC AA CO O02 TSB Modem. ACIA.Command release RTS' (maybe) 
0121- 8D 78 CO 0228 .1 STA Z.RAM.Bank. Reg+5 

0124— A | 0229 LDA pare countensre fig next byte count 
0126—- DO 0 023 BNE . 


...-Continued on page 16 
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Expanding Your IIc 
Is Easy 


With Z-RAM 


Applied Engineering and Apple computer have teamed 
up to take your IIc to new heights. 


Applied Engineering’s Z-RAM card for the Ilc is available 
with 256K or 512K of additional memory and a powerful 
Z-80 microprocessor for running CP/M software. 


Z-RAM fits neatly inside the IIc. Installation is easy, clear 
instructions show you how. You'll need a screwdriver and 
about 10 minutes (if you can change a light bulb you can 
install Z-RAM). 


Z-RAM and Appleworks will knock your socks off. 


‘A 256K Z-RAM will give you a 
229K available desktop and 
Appleworks will be completely 
loaded into memory. Appleworks 
will now run about 10 times faster 
in your IIc with 1 disk drive 

than in other Ilc’s with 2 disk 
* drives. A 512K Z-RAM will give 
you a 413K available desktop. 

A 256K Z-RAM can be upgraded 
to 512K by just plugging in 
more memory chips. 

Z-RAM is also a high speed solid state disk drive. With 
Z-RAM, your programs will load and save over 20 times 
faster. Z-RAM’s RAM disk is compatible with Applesoft, Pro- 
DOS, DOS 3.3, PASCAL and CP/M. And with Z-RAM, you 
can copy a disk in one pass. Just insert the original, 
remove the original, insert blank disk! That’s it! Z-RAM is 
another disk drive, only 20 times faster, 4 times larger 
capacity, and no whirring, clicking or waiting! 


AROLEWORKS HAS 4) 3k 
RAVER ABLE 


RAMDRIVEIS ENGAGED 


DRESS RETURN TO BEGIN = 


But before you start panting over all that extra memory, 
don’t forget that the Z-RAM card has a built-in high speed 
Z-80 processor chip that allows you to run CP/M programs 
like Wordstar, dBASE II, Turbo PASCAL, Microsoft BASIC, 
FORTRAN and COBOL and over 3,000 other CP/M 
programs. So Z-RAM not only makes Apple programs run 
better and faster, it lets you run MORE programs. 


With the Z-RAM card installed, your IIc is still your IIc 
only now you'll have that extra memory that Appleworks 


and other programs need. And you can run all that great 
CP/M software that others can only dream about. 


Z-RAM is 100% compatible with all IIc software and 
hardware including the mouse, 2nd disk, modem and 
printer. Z-RAM is easily handled by the IIc power supply as 
power consumption is kept very low by using two custom 
integrated circuits and a patent pending power saving 
design. And Z-RAM is from Applied Engineering, the 
acknowledged leader and innovator of accessories for the 


Apple. 


Z-RAM comes complete with manual, RAM disk software, 
Z-80 operating system, CP/M manual and a 3 year no 
hassle warranty. 


So the next time somebody asks you why you didn’t get 
an IBM P.C., tell him you bought a IIc because the IBM 
didn’t have enough memory and was too slow and 
couldn't run CP/M software. And tell him you made it past 
the 8th grade. 


Z-RAM with 256K 
Z-RAM with 512K 


$449 
$549 


If you want to run CP/M software, but don’t need more 
memory, may we suggest our Z-80c card. The Z-80c offers 
the same CP/M performance as Z-RAM but has no memory 
expansion ports. And the Z-80c will not affect the running 
of Apple programs. The Z-80c is priced at only $159.00 and 
should you ever want to upgrade to Z-RAM, we'll refund 
your full purchase price. 


Call (214) 241-6060 
9 am. to 11 p.m. 7 days a week or 


Send check or money order to: 
Applied Engineering 

P. O. Box 798 

Carrollton, Texas 75006 


MasterCard ggg Visa and 


C.O.D. welcome. No extra charge for credit cards. 
Texas residents add 5%% sales tax. Add $10.00 if 
outside U.S.A 


AR 


APPLIED ENGINEERING 


“We Set the Standard”’ 
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How Many Bytes for each Opcode?...........eBob Sander-Cederlof 


I have been thinking about a semi-automatic object code 
relocation scheme lately. Steve Wozniak wrote one for the 6502 
back in 1976, published in various places such as Call APPLE's 
“Wozpak”®. But we are needing one for the 65C02, and maybe for 
the 65816. 


Steve's version used his “Sweet-16" interpreter for some of the 
address arithmetic. That was okay, because Sweet-16 was in ROM 
in every Apple in those days. Not so now, although it is 
available to DOS 3.3 users as part of the Integer BASIC 
package. But we should write one that does not require 
Sweet-16 - 


Steve's relocator also used a ROM-based routine (part of the 
built-in disassembler) to determine how many bytes are used by 
each opcode. This routine has been modified in the //c monitor 
and the new enhanced //e monitor to include the 65C02 opcodes. 
That's nice. because that means Woz's program will 
automatically work with 65C02 programs if you run it with the 
new monitors. However, since I want to include all the 65816 
opcodes, I need a new version. 


The first step seems to be to write a program which will tell 
me how many bytes each opcode uses. I know that opcodes which 
are only one or two bytes do not need any relocation 
adjustments when a program is moved to a different place in 
memory. Most 3-byte and all 4-byte instructions contain 
absolute addresses; if an absolute address is inside the 
program being moved, it will have to be adjusted for the new 
location. 


I haven't written the entire relocator yet, but I have written 
a program which will tell me all I need to know about the 
length of an opcode. My program returns the length in bytes 
and also two flags. One flag indicates the opcode is a 3-byte 
instruction which does include an absolute address. The other 
flag indicates the opcode was an immediate mode instruction. 
Immediate mode in 65816 code is ambiguous in length, except 
during execution. My program calls them two-byte instructions, 
but they may be three bytes each if the status bits so indicate 
at execution time. I am not sure how my relocator will handle 
this ambiguity, but for now I am content just to set a flag. 


The code in the monitor which determines the length of opcodes 
uses a table lookup method. I figure that I could do that too, 
with a 64-byte table, using two bits for each opcode. I would 
still need a way to test for immediate mode and the special 
three-byte opcodes which do not have absolute addresses (MVP, 
MVN, PER, and BRL). 


After looking at a chart which showed all the lengths, I 
decided to do it with bit analysis rather than table lookup. 
It is probably a little slower, but also a little smaller. 


It turns out that almost all of the opcodes whose second hex 
digit is less than 8 use two bytes. There are only nine 
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exceptions. One interesting case here is BRK, which assembles 
to only one byte but is considered by the microprocessor to be 
a two-byte opcode. I am not Sure whether the relocator should 
considere BRK as a single byte or a two-byte opcode, but I 
think it should probably be one byte. 


All opcodes of the with the hex values of $x8, $xA, and $xB are 
one byte, without exception. All opcodes with the hex values 
$xC, $xD, and $xE are three bytes with absolute addresses, with 
only one exception: $5C is a four-byte instruction. All 
opcodes with value $xF are four bytes each. 


The column of opcodes with values $x9 are divided into two 
groups. Those with the first digit even ($09, 29, 49, etc.) 
are all three bytes each with absolute addresses. The odd ones 
are immediate mode opcodes, which may be either two or three 
bytes each depending on status bits during execution. 


Here is a table of the various byte counts, which was actually 
computed by my program. I printed “2#" for immediate mode 
opcodes, and “3+" for three-byte opcodes with absolute 
addresses. 


0123 45 67 8 9 ABCD EF 
0 22 2 2 2 22 2 1 «241 «21 « «3+ 3+ 3+ 4 
1222 2 2 2 2 2 1 «#341 #21 «3+ 3+ 3+ 4 
2 3+2 4 2 2 2 2 2 «21 241 «21 «3+ 3+ 3+ 4 
3 22 2 2 2 2 2 2 «21 «3421 «21 «3+ 3+ 3+ 4 
4 1 2 2 2 3 2 2 2 1 4241 «1 « «=3+ 3+ 3+ 4 
5 22 2 2 3 2 2 2 1 #341 21 #4 «3+ 3+ 4 
6 12 3 2 2 22 2 1 #21 #1 «3+ 3+ 3+ 4 
7 222 2 2 2 2 2 1 «3+1 21 «3+ 3+ 3+ 4 
8 22 3 2 2 2 2 2 1 «241 «421 «3+ 3+ 3+ 4 
9 222 2 22 2 2 1 #341 #1 «23+ 3+ 3+ 4 
A 222 2 2 2 2 2 1 «21 1 «3+ 3+ 3+ 4 
B 22 2 2 2 2 2 2 1 #341 1 «23+ 3+ 3+ 4 
Cc 222 2 2 2 2 2 1 «241 «1 «23+ 3+ 3+ 4 
D 222222 2 2 «41 #341 «21 «3+ 3+ 3+ 4 
E 22222 2 2 2 1 #21 #1 3+ 3+ 3+ 4 
F 22 2 2 342 2 2 1 #3+1 #1 #=+%3+ 3+ 3+ 4 


The program which printed the table is in lines 1050-1320 
below. The program which computes how many bytes in an opcode 
follows that. By inserting a “BEQ .6*% between lines 1410 and 
1420 I could make BRK a one-byte opcode. 


My relocator should probably also be on the lookout for calls 
to ProDOS MLI. This is in effect a six-byte instruction. The 
first three bytes are $20, $00, SBF (JSR MLI). The fourth byte 
is the MLI function code. The last two bytes are the address 
of a parameter table, and so should be considered as a 
relocatable address. 


I hope to continue to pursue this idea of a relocator, but I 


make no promises. Maybe one of you would like to write one and 
share it with the rest of us. 
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1000 #SAVE S.BYTE TABLE 
FDED- 1020 COUT .EQ $FDED 
FD8E- 1030 CROUT °EQ $FDBE 
1050 T 
0800- A200 ~—«'1080 LDX #0 
0802- 8A 1070 1 TXA 
eae ie epee 
er gm 11, By cham 
O80B- 20 31 08 1120 JSR GET. LENGTH. OF. OPCODE 
OBOE- 48 1130 PHA 
Te Ee 
Bie gm a Con 
0817- OA 1150 ASL POSITION XY FOR INDEX 
ace oe 
O814- 29 03 1210 AND #803 0000 Ooxy 
O81D- BO 2E 0B 1230 LDA TABLE,Y 
0820- 20 ED FD 12 JSR COUT 
0823- 49 40 1250 LDA #" * 
0825- 20 ED FD 1260 JSR COUT 
0826- £8 1270 INX 
0829- DO DT ~—s-: 1280 BNE .1 
O82B- AC BE FD 1290 , JMP CROUT 
O82E- AO A3 AB 1310 TABLE «AS -/ #+/ 
1330 ® CALL WITH (A)= OPCODE 
1340 @ RETURN WITH 1}= OPCODE 
1350 ® A)= XYOOOLLL 
1360 ® LLL = # OF BYTES, 1...4 
1379 & X = 1 IF ABS ADDRESS 
1380 ® Y = 1 IF IMMEDIATE 
1320 a ae ee ee a a ee eae 
1100 GET. LENGTH. OF. OPCODE 
0831- a8 1410 TAY 
eae te ip 
oB%6° 96 1g woe A xxax ox 
ee ae IM 
Se, | SE N11, 
0842- FO 03 1560 o--pe3t®9 nes 0101 1100, L=4 
O844- a9 83 3s «41520 .1st—CL AAs #983 
oe i2ha @ 4 
O847- a9 Oh «=—s«sd550 .2”-s—‘<CLSé@S AA #H“‘)( St(‘(‘;C;7;7;7;7; 
084 
+ eS san 
O84A- C9 09 =: 1580 3 CHP #$09 
OBNC- DO 32 1590 «rE oe x8, XA, or XB 
OB AER 2 1 «=—«N8 AND #$10 
0851- DO FI 1630 BNE .1 XXX1 1001, L=3 
1640 #---xxxX0 1001, IMMEDIATES, L=2--- 
0 5 = 49 42 1650 LDA #$ho OR 3 iF ## MODE 
1670 Se HEXX OXTX-——-——mn nna nn nanan 
0856- 4A 1680 .4 LSR CHECK ODD/EVEN 
ear ne iT 
O85B- FO EA 710 BEQ . JSL LABS, L=4 
Ober. Fo gs 48° te a JSR ABS, L 
apes co kg Hho Gy fag ON AE 3 
OBee- CO 60 1760 CPY #$60 — 
0867- FO 17 ~—«:1770 BEQ . RTS, L=1 
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lic SYSTEM CLOCK 


e Fully ProDos compatible 


e Automatic time and date stamping 
e Easy to use from BASIC 


¢ Battery operated, uses 3 “AA” batteries (will last 1-2 years before 
simple replacement) 


e Date has year, month, date and day of week 

e Time has hours, minutes and seconds 

e Will time and date stamp AppleWorks files 

e Will display time and date on the AppleWorks screen 


« Auto access from AppleWorks data-base (just use a time 
and date field) 


e Pass through serial port - The IIc system clock can plug into either 
the modem or printer serial port, then modem or printer 
plugs into the clock 


e No hassle 5 year warranty 


« Only $79.00 


“We Set the Standard”’ 
214-241-6060 APPLIED ENGINEERING 9AM-11PM 
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0869- CO 62 1780 CPY #$62 
O86B=- FO 16 tae BEQ 3] PER LREL, L=3 
O86D=- CO 82 1800 CPY #382 
O86F- FO 12 1810 BEQ 34 BRL LREL, L=3 
0871= CO 44 1820 CPY #344 
0873=- FO OE 1830 Q. MVP, L=3 
0875= CO 54 1840 CPY #354 
eo FO OA 1850 BEQ . MVN, L=3 
0879— CO F4 1860 CPY #$3F4 
087B= FO C7 1870 BEQ . PEA ABS, L=3 
18 0 fame] =2 OBES OC OOS FOFFVVOSOQSS OOGSVOSO@ 
087D=- AJ 02 1890 5 LDA #2 Lz2 
O87F- 6 1900 RTS 
1330 town] =] mmm e meee meee em woeeeweeen= 
0880- AQ 01 1920 .6 LDA #1 
0882—- 60 1 Re RT 
088 03 «0.7 ABS 
oBBe— 83 1960 
1970 Wee ee cl eee eee cans 


---Continued from page 10 


0128— A5 28 0231 LDA Sy eeoun ener 

012A- DO 02 0232 BNE . 

012C- C6 2 023 DEC Byte.Counter.Hi 

012E- C6 2 0234 .2 DEC Byte.Counter .Mid 

0130- C6 2 033 3 DEC Byte.Counter.Lo 

0132- 54 CO 0236 LDA Pagel access main text page 
$1337 EE 27 04 9334 INC 4137 show we printed a byte 
0138= 55 CO 02 LDA Page2 back to aux 

013B- A6 2 0239 LDX Transmit. Adr.Lo 

013D—- AK 25 02 LDY Transmit. Adr.Hi 

Ot RE- 2c 83 CO 0241 BIT LCRAM2 normally use LC bank 2 
0142- 9 O2k2 TYA 

ota 29 FO 024 AND #$F0 

0145—= C9 CO 024 CMP /$C000 if adr in $CXXX range 
Ode DO of 024 P 

0149— 2C CO 02 BIT LCRAM1 use LC bank 1 

O14c- 98 O24 TYA 

014D- 09 DO 024 ORA /$D000 

O14F- A Baan TAY 

0150=- A5 26 0250 .4 LDA Transmit .Bank 

0152= HC 11 00 0251 JMP Read 

ee 8D 98 CO 0252 R.Ret STA Printer. ACIA.TxD 

0158- E6 2k 025 INC Transmit.Adr.Lo fig next transmit adr 
015A=- DO 20 0254 ° BNE Next 

015C= E6 25 OEE INC Transmit.Adr.Hi 

015E- DO 1C 02 BNE Next 

0160—- A5 26 02 LDA Transmit .Bank 

0162- C9 01 025 CMP #1 clear carry if 0, else set it 
0164— 69 01 0298 ADC ] 

0166- C9 10 0 CMP #$10 | 

Blene 90 08 0261 BCC 34 =rentering/still in Z=-RAM 
O16A= AQ 00 0262 LDA #$00 wrap to //c bank 0 
016C- A2 TF 026 LDX #IIc.Aux.Bank. Avail 

016E- AO 01 026 LDY /IIc. Aux. Bank. Avail 

gi79- 80 O04 0263 BRA .2 

0172=- A2 1E 0 1 LDX #Z.RAM.Banks. Avail 

Ot ee AO 0 026 LDY /Z.RAM.Banks. Avail 

0176- 85 2 0268 .2 STA Transmit. Bank 

017A= 84 25 027 STY Transmit.Adr.Hi 


0271 Cant.Transmit 
017C= 4C 2B 00 0272 Next JMP Scan 
bis 0273 IIc. Aux.Bank. Avail ea 
0 Q1- 02 BufLen .eq $90000-Z. »Used-IIc. Aux.Bank. Avail 
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Generic Conversion RoutineS........esee+++eBob Sander-Cederlof 


I may have written hundreds of different versions of the 
elementary I/O conversion routines. The first few would have 
been for the IBM 704, back in college days. Then there was the 
G-15, the 1620, the 3100, the 3300, the 6600, the 1700, the 
8090, the 960, the 980, the 990, and so on. Don't worry of 
those numbers don't mean anything to you. They are the “names* 
of computers out of the past, not micro chips. 


What I am talking about is writing programs which convert input 
decimal characters representing decimal numbers into internal 
binary form, and the converse operation of converting binary 
numbers into decimal form. We have published several 
variations of both in previous newsletters, but I have some 
Special ones to present here. 


There are many variations of the basic routines, and that is 
one reason I have written so many. Thinking just of the output 
conversions (binary to decimal): 4 


Convert to a string in memory, or print it out. 
Number of bytes in binary number. 

Supply leading zeroes or blanks or neither. 
Integer, fraction, floating point, or fixed point. 
Signed or unsigned. 


+ + + 6 F 


The routine I set out to write today works with unsigned 
integers, prints out the resulting characters rather than 
storing them in a string, and does not print any leading zeroes 
or blanks. I wrote it to work with two-byte values, between 0 
adn 65535. As an added feature, I indicated in the comments 
how to expand it to work with larger values. 


Lines 1800-2080 in the listing comprise the output conversion 
routine. I divide the number by ten, saving the remainder as 
the least significant digit; the quotient becomes the new 
number, so I repeat the process until the quotient is zero. 
Then the digits, which were all saved on the 6502 stack, are 
popped back off and printed. 


Line 1810 starts the digit counter at 0, and line 1950 
increments the counter each time a new digit is pushed onto the 
stack. Lines 2020-2060 pull the digits off the stack and print 
them in reverse order. 


Lines 1970-2000 test the quotient: if it is non-zero, another 
division is performed; if not, we are ready to print the 
result. This is one place where you need to add code if your 
input values are larger than two bytes, as I indicated in line 
1980. By the way, since we do one division before testing, an 
input value of zero will print as “0". 


Lines 1830-1930 divide the input value by ten. It may look 
like I am dividing by five, but remember 5 = 10/2. I did more 
fiddling than analyzing in this loop, but it really does work. 
Line 1840 sets the loop count to 16, the number of bits in two 
bytes. If you want to convert three-byte values, change the 16 
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to 24. The loop needs to be executed once for each bit in the 
input value. If you are going to have values longer than two 
bytes, you also need to add more ROL instructions between lines 
1880 and 1900, as indicated in my comment line 1890. If you 
were to need a three byte conversion routine, you could just 
remove the “*--" from the front of lines 1890 and 1980, and 
chane line 1840 to LDY #24. 


Notice that this subroutine is very short. and fairly fast. I 
have an idea that some of you will think of ways to make it 
shorter and faster; if you do, try to keep it easily modifiable 
for the number of bytes in values. 


Next I wrote a program to convert from a decimal string into 
binary, lines 1290-1720. It is also set up for unsigned 
two-byte integer values, with comments indicating how to modify 
it for longer values. I have written shorter routines before, 
but this one makes extension to longer values easy and tests 
for overflow. 


The string is assumed to be in ASCII, with high bits =l, 
starting at $0200, and terminated by any non-digit. It just so 
happens that these are just the conditions you usually find in 
an Apple, because almost all input routines use the buffer at 
$0200. Woz started it, and we all followed Woz. 


Lines 1300-1330 clear the value, as well as starting the buffer 
index at zero. The rest of the routine scans through the 
digits. Each time the current value is multiplied by ten, and 
the next digit added. If at any point an overflow is detected 
(a value too large for the number of bytes) the routine rings 
the bell and quits. You can use some other error indication, 
and probably should, such as printing “NUMBER TOO LARGE". 


In order to multiply by ten, I set aside another storage area 
equal in length to the value accumulator. At line 1380 the new 
digit is saved in the Y-register. The accumulated value at 
this point is in XH and XL. Lines 1390-1480 form the value*4 
in SH and XL, leaving the original value in XH and SL. (Yes, 
they are criss-crossed.) Lines 1410-1420 show how you would 
extend this portion to longer values. 


Lines 1490-1610 add value*4 to value to get value*5, and then 
double the result to get value*l0. Again, lines 1530-1550 show 
how to extend the value. Lines 1630-1700 add in the new digit, 
and the comments show how to extend to longer values. 


The top level routine in lines 1130-1270 is just a test 
routine. It calls the monitor line input routine. If you type 
an empty line, it will stop. Otherwise it calles the input 
conversion routine, prints the resulting value in hexadecimal, 
and converts it back to decimal with the output conversion 
routine. 
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SESCEEEEEESESESESEESESESEEEEESEESEEEEEEEEEESEEEEES 


DISASM 2.2e - AN INTELLIGENT DISASSEMBLER : $30.00 
Investigate the inner workings of machine language programs. DISASM converts machine code into meaningful, 
symbolic source. Creates a standard text file compatible with S-C, LISA, ToolKit and other assemblers. Handles 
data tables, displaced object code & even lets you substitute your own meaningful labels. (100 commonly used 
Monitor and Pg Zero names included.) An address-based triple cross reference table is provided to screen or 
printer. DISASM is an invaluable machine language learning aid to both novice & expert alike. Don Lancaster 
says DISASM is “absolutely essential” in his new ASSEMBLY COOKBOOK. For entire Apple Il family including the 
new Appie //c (with all the new opcodes). SOURCE CODE available for an additional $30.00 


LOW LOW PRICE !!! C-PRINT For The APPLE //c : $69.00 
Connect standard perailel printers to an Apple //c. C-PRINT is @ herdware accessary that plugs into the 
Standard Apple //c printer serial port. The other end plugs into any printer having a standard 36 pin 
centronics-type parallel connector. Just plug in and print! High speed data transfer at 9600 Baud. No need to 
reconfigure serial port or load software drivers for text printing. 


FONT DOWNLOADER & EDITOR : $39.00 
Turn your printer into a custom typesetter. Downloaded characters remain active while printer is powered. 
Use with any Word Processor program capable of sending ESC and control codes to printer. Switch back and 
forth easily between standard and custom fonts. All special printer functions (like expanded, compressed etc.) 
apply to custom fonts. Full HIRES screen editor lets you create your own characters and special graphics 
symbols. Compatible with many parallel printer I/F cards. User driver option provided. For Apple {l, lit, //e. 
Specify printer: Apple Dot Matrix, C.ltoh 8510A (Prowriter), Epson FX 60/100, or OkiData 92/93. 


The Font Downloader & Editor for the Apple Imagewriter Printer. For use with Apple Il, Il+, 
//e (with SuperSerial card) and the new Apple //c (with builtin serial interface). 


FONT LIBRARY DISKETTE #1 : $19.00 Contains lots of user-contributed fonts for all printers 
supported by the Font Downloader & Editor. Specify printer with order. 


The ‘PERFORMER’ CARD : $39.00 
Plugs into any slot to convert a ‘dumb’ centronics-type printer |/F card into a ‘smart’ one. Command menu 
eliminates need to remember complicated ESC codes. Features include perforation skip, auto page numbering 
with date & title. Includes large HIRES graphics & text screen dumps. Specify printer: MX-60 with 
Graftrax-60, MX-100, MX-80/100 with Graftraxplus, NEC 6092A, C.ltoh 8510 (Prowriter), OkiData 8B2A/83A 
with Okigraph & OkiData 92/93. SOURCE CODE: $30.00 


FIRMWARE FOR APPLE-CAT: The ‘MIRROR’ ROM : $25.00 
Communications ROM plugs directly into Novation’s Apple-Cat Modem card. Basic modes: Dumb Terminal, 
Remote Console & Programmable Modem. Features include: selectable pulse or tone dialing, true dialtone 
detection, sudible ring detect. ring-back. printer buffer, 60 col card & shift key mod support. Uses superset of 
Apple's Comm card and Micromodem |i commands. SOURCE CODE: $50.00 


RAM/ROM DEVELOPMENT BOARD : $30.00 
Plugs into any Apple slot. Holds one user-supplied 2Kx8 memory chip (6116 type RAM for program development 
or 2716 EPROM to keep your favorite routines on-line). Maps into $Cn00-CaFF and $CB00-CFFF. 


ALL NEW /// TAIN ss/C PRODUCTS 


MIDI means Musical Instrument Digital interface. Use your computer with sny MIDl-equipped music keyboard for 
entertainment and music education. Low cost MIDI player interface cable, complete with 6 song demo disk: 
$49.00. Thousands of popular songs available soon on diskette (also compatible with Passport MIDI interface). 


Products for both the Apple lic and Commodore 64/128. Unique general purpose MIDI expander cable and gender 
Changer also available. Send SASE for product descriptions and prices. 


Aveid @ $3.00 handling charge by enclosing full payment with order. VISA/MC and COD phone orders accepted. 
RAK-WARE 41 Ralph Road WwW. Orange NJ 07052 (201) 325-1885 
SCESCECEEESEESEESEEEEEEEEEEEEEEEEEEEESCEEES 
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1000 *SAVE S.BINDEC 
1010 Sememnnn en enw wn mm wwe wwe wenn 

00—- 1020 XL ~-EQ $00 

is eae Be 

11- yh SH EQ $11 

FBDD-=- 1070 BELL ~EQ $FBDD 

FD6A- 1080 RDLINE .EQ $FD6A 

FDDA= 1090 PRB -EQ $FDDA 

FDED-= 1100 COUT EQ $FDED 

8E- 1110 CROUT .EQ $FD8E 

rence 

0800=- 20 6A FD 1180 JSR RDLINE 

0803—- 8A 1150 TXA 

SRoé. bo”! tn RIS 

0807=- 20 22 08 1190 1 JSR CONVERT .DEC.TO.BIN 

O80A=- A5 01 1190 LDA XH 

O80C=- 20 DA FD 1200 JSR PRBYTE 

O80F- A5 00 1210 LDA XL 

0811- 20 DA FD 1220 JSR PRBYTE 

OB 16. 80 ED ED ioko GSR COUT 

0819= 20 Bp FB ieee JSR CONVERT.BIN.TO.DEC 

081C= 20 8E FD 1260 JSR 

O81F= 4C 00 08 ioho ‘ JMP 
1290 CONVERT.DEC.TO.BIN 

0822= A2 00 1300 LDX #0 

0824~ 86 00 1310 STX XL least significant byte 
1356 ft... STX XI @---ANY INTE DIATE BYTES--- 

0826- 86 01 1 Be STX XH most significant byte 

0828—- BD 00 02 1340 .1 LDA oe 

OROD- CO OA 1360 ENE #10 

O82F=- BO 36 1 fe BCS .3 --eEND OF NUMBER 

0831— A8 1380 TAY SAVE CURRENT DIGIT 

OBaa- 82 40 1RGO STA SL 
1410 #-— LDA XI ---ANY INTERMEDIATE BYTES--- 
1420 #-- STA SI ---FOLLOW THIS PATTERN-<----- 

0836—- A5 o4 Mee LDA XH 

OB B= 25 $e 08 oe Beg SHIFT .X OVERFLOW 

083D=- 20 as 08 1820 JSR SHIFT.X 

O840- BO 22 uy BCS .2 ee e OVERFLOW 

O842—- 85 11 14 STA SH 

OB44- 4 1490 CLC 

O845— A5 00 1500 LDA XL 

a a ee 
aka ti. LDA XI @---ANY INTERMEDIATE BYTES--- 
1540 #-— ADC SI ---FOLLOW THIS PATTERN-----=- 
1590 Bee STA XL ewww ewennnennceecerencneeens 

gBup- e291 (t2e8 ADC. SH 

O84F- BO 13 1260 BCS .2 . + «OVERFLOW 

0851- 20 68 08 1590 JSR SHIFT.X 

gace~ BS on dene STA ii canada 

0858- E 1620 INX SCAN TO NEXT DIGIT 

0859- 28 1630 TYA GET DIGIT 

O85A- 65 00 1640 ADC XL LEAST SIGNIFICANT BYTE 

opeee 30 os 1030 Bce A NO CARRY 
1970 tow INC XI @---ANY INTERMEDIATE BYTES--- 
1680 #— BNE .1 #---FOLLOW THIS PATTERN=-<----= 

0860- E6 01 1690 INC XH MOST SIGNIFICANT BYTE 

0862= DO C4 1700 BNE .1 «»eUNLESS OVERFLOW 

0864—- 20 DD FB 1710 .2 JSR BELL SIGNAL OVERFLOW 

0867- 60 1430 22 RTS 
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1740 : 
0868— 06 00 1750 ASL XL LEAST SIGNIFICANT BYTE 
1760 #-- ROL XI ---ANY INTERMEDIATE BYTES--- 
O86A=- 2A 770 ROL eeeMOST SIGNIFICANT BYTE IN A 
O86B- 60 1150 RTS 
1800 CONVERT ..BIN.TO.DEC 
086C- A2 00 1810 LDX #0 DIGIT COUNTER 
1820 #--=DIVIDE BY TEN---------------- 
O86E- AQ 00 1830 .1 LDA 
0870- a0 10 1840 LDY #16 2*(# Bytes being converted) 
Orie C9 05 1850 .2 CMP #5 
0874- 90 02 1860 BCC .3 
0876- E9 05 1870 SBC #5 
0878- 26 00 1880 .3 ROL XL 
iene a ROL XI ---ANY INTERMEDIATE BYTES--- 
O87A= 26 01 1900 ROL XH 
O87C- 2A 1910 ROL 
O87D- 88 1920 DEY 
Oo iE DO F2 1230 BNE .2 
0880—- 48 19 PHA SAVE DIGIT ON STACK 
0881- E8 1950 INX COUNT THE DIGIT 
1960 #---NEXT DI GIT----2--.---- 2 
0882- A5 00 dann LDA XL 
1980 #— ORA XI ---ANY INTERMEDIATE BYTES--- 
O884- 05 01 1990 ORA XH 
OBB OO ee ENG e-—-PRIGY DECIMAL 
0888- 68 2020 .4 PLA 
0889- 09 BO 2030 ORA #*0* 
O88B- 20 ED FD 2040 JSR COUT 
O88E- CA 2050 DEX 
O88F- DO F7 2060 BNE .4 
0891- 60 ; 7 ‘ RTS 


8086/8088 Cross Assembler 


Use your Apple to learn 8086 programming! You can program for 
the IBM PC, the clones, and ALF‘'s co-processor board without 
ever leaving the friendly environment of Apple DOS 3-3. 


This easy-to-use cross assembler, based on the S-C Assembler II 
(Version 4.0), covers all the 8086 and 8088 instructions and 
all the addressing modes. Instruction mnemonics are based on 
the Microsoft 8086 assembler. Does not include newer S-C 
Assembler features like macros or the EDIT command. 


Documentation covers the differences from standard S-C 
Assembler operation and syntax. Sample source programs help 
you become familiar with the assembler syntax. 


With permission from S-C Software, XSM 8086/8088 is available 
to owners of any S-C Assembler for $80.00 post-paid. (No 
credit cards or purchase orders.) 


Don Rindsberg 
The Bit Stop 
5958 S. Shenandoah Rd. 
Mobile, AL 36608 


(205) 342-1653 
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A Wildcard Filename Search........e.eeeeeeeBObD Sander-Cederlof 


Over the years I have fallen into certain habits when it comes 
to naming files. I find it convenient to use names starting 
with "S." for assembly language source files, "B."“ for binary 
object code files, and so on. Others like to use suffixes like 
“.SRC” and ".OBJ“ for the same reasons. Some operating 
systems, like CP/M for example, use suffixes to indicate file 
type- Others, like ProDOS, let you build sub-directories to 
categorize your files. 


Sometimes I would like to have the ability to do the same 
operation on a whole group of files. For example, I might want 
to DELETE all files starting with “B.“. Or I might want to 
copy a whole group of files from one disk to another. If the 
files happen to have similar names, and if DOS allowed 
wildcards in filenames, it would be easier. 


Some DOS 3.3 programs do have this feature: Apple's FID 
program, Sensible Software's Super Disk Copy, and others. They 
have a method for specifying a filename without spelling out 
the entire name. 


The subroutine inside DOS 3.3 which compares a filename you 
have specified with the names in a catalog is found at SBIF5: 


LDY #0 
INX 
INX 

ad INX 
LDA ($42),¥ Filename you specified 
CMP $B4C6,X Filename in catalog sector 
BNE ... eee-did not match 
INY 
CPY #30 
BNE .1l 

eee matched ... 


This is a very straightforward string comparison. It requires 
an exact match of all 30 characters of a filename. There is a 
Similar routine at $A782 which compares a filename you specify 
with the filenames in the open file buffers. 


I wrote a subroutine called MATCH which compares two 
30-character strings, allowing wildcards. Unfortunately, it 
not a simple matter to plug such a subroutine into DOS 3.3, and 
I have not done that. It is more likely that this subroutine 
will find its way into some future utility programs. 


I also wrote a testing program, so that I could see if my code 
worked. The program in lines 1110-1380 searches through a list 
of 30-character strings, printing those which match a key 
string. To simplify my test program (a good idea to keep 
testers simple, so they are not themselves more buggy than the 
testees!) I assembled in the key string and the list of strings 
to be searched. A slightly better test would allow me to type 
in the key string. 
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NZI ITETTTs se) 
WATTTTTTeTt sa 


a 5 AN ZTIES saa 


Fatter than a Fat Mac and ready for serious business — 
that’s an Apple //c with a MultiRam™ C Card installed. 
MultiRam adds from 256K to 512K to your //c’s own 128K 
memory to give you up to a 640K //c. 


With a 640K Apple //c you can... 


@ Run AppleWorks with a 413K Desktop. That's a Desktop 
large enough for the most demanding business or 
personal use. Data bases and spreadsheets can grow 
beyond the frustrating limitations of the old 55K 
Desktop. 


You can even eliminate AppleWork’s need for an exter- 
nal disk drive and speed up AppleWorks by loading all 
the program disk into MultiRam’s memory. 


@ Run the new SuperCaic34, an integrated spreadsheet 
for your //c with the power of Lotus 1-2-3, and create 
complex models up to 512K in size. 


@ Run FlashCalc, Magic Office, MagicCalc and future 
programs that will use most or all of MultiRam’s 
memory. 


Apple is the registered trademark of Apple Computer, Inc. 
AppleWorks and Macintosh are trademarks of Apple Computer. Inc 
FlashCalc is the trademrk of Paladin Software Corporation 

Lotus 1-2-3 is the trademark of Lotus Development Corporation 
Magic Office and MagicCalc are trademarks of Artsci. Inc. 
SuperCaic3? is the trademark of Sorcim/IUS. Inc. 


@ Use MultiRam C’s memory as a RAM disk for ProDOS 
and DOS equaling up to four standard //c disk drives 
with speeds more than 20 times normal. 


The MultiRam C Card... 


® Easily installs inside the //c using only a screwdriver. 
No messy soldering or jumpers are required. Multi- 
Ram’s expandable memory is_ easily increased if you 
choose a 256K version. 


@ Includes a comprehensive manual, AppleWorks mem- 
ory expansion software, ProDOS and DOS RAM disk 
software, and RAM test software at no additional 
charge. 


@ Features a full 5-year warranty and is 100% compatible. 
with all //c hardware and software. MultiRam uses a 
low 1.2 watts of power with its CMOS power saving 
design. CMOS insures longer sessions when using a 
battery pack with your //c. 


Available at a DISCOUNT from: 


Coit Valley Computers 
14055 Waterfall Way, Dallas, Texas 75240 


214-234-5047 


Checkmate Technology, Inc. 


509 South Rockford Drive * Tempe, Arizona 85281-3021 
(602) 966-5802 USA. Telex: 165-025 CEC PHX 
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My MATCH program assumes that the address of the string to be 
compared with the key is stored at FN and FNt+l. Characters in 
the filename are addressed by "(FN),Y", and in the key are 
addressed by “KEY,X". MATCH will return with carry set if the 
filename matches the key, and carry clear if not. 


Both the filename and the key are stored “left-justified, 
blank-filled“. That means there may be any number of 
non-significant blanks on the right end. Lines 1490-1530 scan 
the current filename from right-to-left, looking for the last 
non-blank in the name. Lines 1550-1590 do the same for the 
key. If there is any chance either filename or key could be 
completely blank, an extra line "BMI ERROR“ should be inserted 
at 1505 and 1565. 


I save the index to the right end of the key in KEY.START. 
Because the end of the filename and key strings is variable, I 
actually do the comparison from right to left. This makes the 
"end“ actually the beginning. 


Line 1610 could be "JMP .4" or “BNE .4", because the object is 
to get to line 1660. However, the “INX" allows me to fall 
through lines 1630-1640 and it takes only one byte rather than 
two or three. 


The comparison begins at line 1660. Remember we are scanning 
backwards, from right to left. Lines 1660-1670 save the two 

string pointers. Line 1680 gets the next character from the 

key. If it is a wildcard, I branch back to line 1630. Note 

that all that happens is that the wildcard is skipped over! 


If the key character is not a wildcard, it gets compared to the 
next character of the filename at line 1710. If it matches, 
lins 1730-1760 advance both pointers and the comparison 
continues. These lines also check to see if we have come to 
the left end of the key or of the filename. 


If we are at the end of the filename, lines 1770-1820 check the 
rest of the key. If there are any characters left in the key 
which are not wildcards, then the current filename does not 
Match. Otherwise, it does match. Lines 1830-1880 set the 
appropriate carry status and return. 


If we are at the end of the key, lines 1900-1910 check whether 
we are also at the end of the filename. If so, the filename 
Matched. If not, maybe it did not match. I say maybe, because 
if there was a wildcard, we might come out with a match if we 
widen the amount matched by that wildcard. Lines 1920-1990 
will handle that possibility. 


Two conditions bring us to line 1930. Either a character in 
the key did not match the current character in the filename, or 
there are unmatched filename characters left over after the end 
of the key. In either case, if there has been no wildcard in 
the key (so far), then the filename does not match the key. If 
there has been a wildcard, we can try again to match from the 
most recent wildcard on. We can tell whether or not there has 
been a wildcard so far by comparing KEY.PNTR with KEY.START. 
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12 Good Reasons Why 
RAMWORKS' Is The Best 
Expansion Card For Your Ile 


1 APPLEWORKS MEMORY Even though Ramworks enhances and 
expands a VAST ARRAY of other programs. Appleworks is our claim to fume. A 
64K Ramworks will ADD 460K to vour available desktop memory, a 128K 
Ramworks will ADD 91K. a 256K Ramworks will ADD 182K. and a 512K 
Ramworks will ADD 364K and a 1 meg Ramworks will give vou nearly an 800K 
desktop. And its all done automatucally! When vou plug in more memory 
chips into vour Ramworks card. Appleworks will find them-—- automatically. 
Ramworks also increases che maximum number of records from 1350 to 4300. 


2 APPLEWORKS SPEED AND POWER Ramworks does more than 
just increase the desktop memory (as if that weren't enough). With Ramworks, 
Appleworks will be able to run up to 20 times faster. If you buy a 256K or 
larger Ramworks card, Appleworks will automatically load itself in Ramworks. 
This gready increases the speed at which Appleworks operates by eliminating 
all that nasty, ime consuming disk access on Drive 1. These are but a few 
reasons why we sav that Ramworks is Appleworks best friend. 


3 EXPANDABILITY Ramworks was designed with the future in 
mind, as your needs increase, so can Ramworks. Clear instructions show you 
how to plug in more memory (up to 1 meg). 


4 SPEED Today, as programs become more and more sophisticated, they 
inevitably become larger. And many of today’s best selling programs (like 
Appleworks) won't fit in a 128K Apple, so many of these new larger programs 
continually go back to disk in search of more data, With Ramworks, vou can 
have enough memory so that the entire program will be loaded into 
Ramworks’ memory. This gready increases the speed of software because vour 
disk runs at 300 RPM, but Ramworks operates at the speed of light’ 


5 COLOR The same slot that’s used for memon expansion ts also the slot 
that’s used for RGB color displav. so all those lesser memory cards of 
yesterday make vou decide in advance if vou want RGB color Onl Ramworks 
lets vou decide later to 2dd RGB color For on $129. an RGB opuon can be 
added tu Ramworks t> give vou double high resoluuon color graphics and 80 
column text AU with a razor sharp. vivid brilliance thats unsurpassed in the 
industry. The RGB option does not waste another valuable slot but cather 
plugs into the back of Ramworks and attaches to any Apple compatible 
monitor. Remember, vou can order the RGB option with vour Ramworks or 
add it on at a later date. 


6 COMPATIBILITY, OF THE SOFTWARE KIND Programs like 
Appleworks, Magic Office System, Flashcalc, The Spread Sheet, Diverse-A-Dos, 
Supercalc, Magicalc and many others automatically recognize all or most of 
Ramworks memory (512K is average). The simple fact is that Ramworks is 
compatible with more off-the-shelf software than any other RAM card. 
Ramworks is 100% compatible with ALL software written for the Apple 80 
column and extended 80 column card. Additionally, Ramworks can emulate 
other RAM cards so software written for other cards will run without 
modification. Software written for RAMWORKS will not work on other cards. 
We can emulate others, but others can't emulate us. 


7 COMPATIBILITY, OF THE HARDWARE KIND Unlike others. 
Raniworks is fully compatible with hardware add on’s from other companies. 
like the Sider and Profile hard disks. And Raumworks was designed in 
accordance with the official expansion rules defined by Apple so vou don't 
have to wor about compatibility problems. As vou continue to expand and 
make vour Apple more powerful with other expansion products from Applied 
Engineering. vow appreciate how each product has extra features designed 
to work with Ramworks and other products to give vou a total performance 
package that is more powerful than the sum of its parts. 


8 IT SELLS THE MOST Popularity translates into great software support 
because software companies cant support all RAM cards, they can only 
support the ones their customers are likely to Own And software companies 
appreciate the fact that when they write software for Ramworks in the He, 


~ 


eae he Ra oe! ane An 


they're also writing software for our memory expansion card for the Ic. 
7-RAM. And our customer list reads like the Who's Who of Apple computing 
with just about every software company in the land buying one, including 
Apple Computer (in the hundreds), Rupert Lissner, and Steve Wozniak (we 
didn't give one to Mr. Wozniak just to use his name. 2 one meg Ramworks 
were paid for at full price). 


9 ITS FROM APPLIED ENGINEERING Unlike most of the 
competition, we only make accessories for Apple, so we'll never spend your 
money on IBM product research. Applied Engineering's vears of experience 
and wide product line really pays off, and because of our high sales levels we 
buy most of our LC. chips factory direct. So don’t let our low prices fool you, 
theyre caused by high volume production. That's why we can offer the most 
memory for the least money. Guaranteed! 


1 0 ITS GOT IT ALL 

Sharp 80 Column Text 

Double high resolution graphics 
(with or without RGB option) 
User Expandable to 1 Megabyte 
Can Use 64K or 256K RAMS in 
any combination 

Adds Memory to Appleworks 
Accelerates Appleworks 

100% Compatibility with 

All Ile software 


& RAM Disk software available. 
compatible with Applesoft, 

PRO- DOS, DOS 3.3, and PASCAL 
($29) 

& RAM Disk available for CP/M 
($29). (This program is included 
with our CP/M card) 

& Visicale preboot available ($29) 

@ RGB option 

@ Takes only one slot 

& 3 year no hassle warranty 


AAG AH AR 


1 1 THE PATENT OFFICE HAS ONE There are many advanced 
features on Ramworks, but two parts of the design are so advanced we 
applied for patents. One patent application deals with our ultra fast: ula 
smooth 80 column screen display, and the other patent application deals with 
our ingenious way of dramatically reducing the power and heat of memory 
chips and improving reliability at the same time. 


1 2 HERE TODAY, HERE TOMORROW In the seven years we've 
been making products for the Apple, we've seen a lot of companies come and 
go. Although nothing is forever, we're growing, expanding and we're 
profiable. And we are totally committed to Apple computing, which means 
youll never cun out of things to do with Ramworks. Or tor that matter, 
reasons to buy one. 


Ramworks” with 04K $179 
Ramworks™ with 128K . . $249 
Ramworks™ with 250K . . $299 
Ramworks” with 512K $399 
Ramworks™ with 1 MEG. ...... $649 
RGB Option (can be added later) $129 


Call (214) 241-6060 

9am. to Ll pam. 7 days a week or send check or money order to: 

Applied Engineering. P.O. Box 798, Carrollton, Texas 75000 
mee 


MasterCard = aml Visa and 
C.O.D. welcome. No extne charge tor credit cards. Texas Residents add 3's 
sales tax. Add $10.00 if Outside U.S.A 


-A 


APPLIED ENGINEERING 
“We Set the Standard”’ 
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If they are the same, there has been no wildcard. Lines 
1920-1990 handle all these details. 


I made the wild card character itself a variable. so that you 
could change it by program control. Since "=" is a valid 
character in a filename, you might want to use something else. 


With this kind of MATCH subroutine, a key of “=.0BJ" would 
match all names ending with “.OBJ“; “S.=" would match all names 
starting with “S."“; “=A=B=" would match all names containing 
“A*® followed by “B". 


You can see the similarity between MATCH and a global search 
capability such as you might find in a word processor, or in 
the S-C Macro Assembler. The FIND and REPLACE commands in S-C 
Macro allow wildcards. However, MATCH differs in that it 
anchors the key to the beginning and end of the file name 
(unless you specify a wildcard in those positions). 


If string comparisons of this type intrigue you, the book 
“Software Tools” develops an extremely powerful one in chapter 
5. “Software Tools" is a classic book by Kernighan and 
Plauger, available at many bookstores. (A “classic” in 
computer books is one still in print after five years; this one 
qualifies, since it was originally published in 1976.) Their 
string match routine allows single- and multi-character 
wildcards, semi-wildcards that match subsets of characters, 
control of anchoring, and more. It would be a worthwhile 
exercise to try implementing their algorithm in 6502 language. 


FDED- 1020 COUT .EQ $FDED 
FD8E- 1030 CROUT EQ FD8E 
10N0 Boceeedenesewcencxcceeccecsadesuda 
00- 1050 KEY.PNTR .EQ $00 
O1- 1060 BUF.PNTR .EQ $01 
02— 1070 FN EQ $02,03 
Oh 1080 KEY.START FQ $04 
05- 1090 CNTR ~EQ $05 
1100 Semaeewenwmewenwen ewww meee nwce 
1110 T 
O800- A9 O4 =-_- 1120 LDA #NAME.CNT 
0802- 85 05 1130 STA CNTR 
O804- a9 Al =—s: 110 LDA #FNLIST 
0806- Ad 1150 LDY /FNLIST 
O808- 85 02 1180 «1 STA FN 
O80A- 84 03 1170 STY FN+1 
O80C- 20 32 08 1180 JSR MATCH 
O80F- 90 1190 BCC .2 ...DID NOT MATCH 
0811- 20 23 08 1200 JSR DISPLAY 
O814- A5 0 1210 .2 LDA FN 
0816- 1 1220 CLC 
0817- 69 1E 1230 ADC #30 
0819- Ah 03:12 LDY FN+1 
081B- 90 01 1250 BCC . 
081D~ C8 1260 INY 
O81E- C6 0 1270 .3 DEC CNTR 
0820- DO E 1280 BNE . 
0822- 60 1290 RTS 
1300 Ge ereen nere ener e nn nnn anne nn nee = 
1310 DISPLAY 
0823- AO 00 1320 LDY #0 
0825- B1 02 = 1330 .1 LDA (FN),Y 
0827- 20 ED FD 1340 JSR COUT 
O82A- C8 1350 INY 
O82B- CO 1 1360 CPY #30 
O82D- 50 F 1370 BCC . 
082F- 4c 8E FD 1380 JMP CROUT 
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If You Have 


APPLEWORKS” 


It's Easy To Tell If You 
Have A Timemaster H.O. Clock 
In Your Apple 


MAIN MENU 


one of the files on the Desktop 


Save Desktop files ta disk 


from the Desktop 


ee 
= 

4 = 

oa 


Only the Timemaster H.O. displays the date and time on. 


the Appleworks screen.” If vou don’t have a Timemaster 
H.O., vou'll just get the help key reminder. The 
Timemaster HLO. will also automatically time and date 
stamp vour files on disk. And don't forget, the Timemiaster 
H.O. has all the features of all the competition combined, 
including vear. leap vear (not just in PRO-DOS), month, 
date. day. hours, minutes, seconds and milliseconds. The 
Timemaster H.O. is compatible with PRO-DOS, DOS 3.3, 
PASCAL and CP M. And the Timemaster H.O. automatically 
emulates all other clock cards so you won't have any 
compaubilin problems because the Timemaster H.O. 
works with ANY program that reads ANY clock. 

In fact vou could put ALL the competitive cards in every 
slovin vour Apple and vou sul wouldn't have all the 
features of the Timemaster HO. 

The Timemaster HO. comes with a ton of fun and 
useful software It hus an easy to read vet detailed manual. 
a 20 vear aut recharging battery and a 3 year no hassle 
Warrant 


Just Look Right Here 


TIMEMASTER H.O. 
SIMPLY PUT, 
IT’S SIMPLY THE BEST $129.00 Complete 


*If you purchased a Timemaster H.O. prior to AppleWorks support, an easy 
to use patch program is available for $20.00. 


APPLIED ENGINEERING 
We Set the Standard 


Call (214) 241-6060 9 a.m. to 11 p.m, 7 days a week or 
Send check or money order 

P. O. Box 798 

Carrollton, Texas 75006 


— 
MasterCard, Visa and C.O.D. welcome. No extra charge 
for credit cards. 


Texas residents add 5%% sales tax. 
Add $10.00 if outside U.S.A. 
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ee 
ikeo ® COMPARE KEY TO A FILE NAME 
1410 # KEY MAY CONTAIN WILDCARDS 
1420 # TRAILING BLANKS DON'T COUNT 
1330 # FILE NAME ADDRESSED VIA "(FN),Y" 
140 @ KEY ADDRESSED VIA "KEY, X* 
1450 & KEY AND FILE NAME ARE UP TO 30 CHARS LONG 
1460 ‘ (STORED LEFT-JUSTIFIED, BLANK=FILLED) 
0 ap > GP Oe Ob GD SD OD OD OE EOE ES OOS OSS SS 2S GC PSS Se 
1450 MATCH 
0832- AO 1E —«: 1490 LDY #30 FIND LAST NON-BLANK CHAR 
0834- 88 1500 .1 DEY IN FILE NAME 
GB BM fa 
of §z FO F9 1330 . BEQ 81 
083B- A2 1E 1350 LDX #30 FIND LAST NON-BLANK CHAR 
O83D- CA 1560 .2 DEX IN KEY 
0 3E- BD 81 08 1570 LDA KEY ,X 
Sens £888 deeo BEQ 2 
agNe 86 Oh 3800 Stk key. sant 
vena. CA ian Seer ADVANCE KEY POINTER 
0849- 30 21 1640 i” BMI .8 ..eEND OF KEY IS WILD, SO MATCHES 
O84B- 86 00 1660 .4 STX KEY. PNTR 
a ey mg 
0852- CD 4 oF 1950 ° CMP WILD.CARD 
Se 2 HES BB yy, crrtzia camp cuacran 
085 - 20 18 1720 BNE «11 , ».eNO MATCH 
O85F- 10 EE 1760 BPL .6 ..e STILL MORE TO COMPARE 
1 70 #---END OF FILE NAME, MORE KEY--- 
See de Be Ba Ob tron 7) BDA KEY 3X app 
0867- DO 05 1880 E.9 .»»REST OF KEY NOT WILD, NO MATCH 
0869- CA 1810 DEX 
O86A- 10 F5 1820 : vatpe uitcn 
i af AR ag aa mares 
” 1860 ®---NOT A MATCH------------------ 
ope a8 1860 RTS 
1380 #.—.END OF KEY=<<<~=----n0---..- 
0870- 88 1900 .10 DEY MATCH IF END OF NAME 
0871- 30 F9 1910 BMI . .eeEND OF NAME 
1920 #---IF AFTER WILDCARD, SLIP------ 
0873- A6 00 1930 .11. LDX KEY.PNTR START KEY OVER AGAIN 
0875- EX 04 1940 CPX KEY. START 
0877- FO F5  —- 1950 BEQ .9 ..eNOT AFTER A WILDCARD 
087 a ad 01 1960 LDY BUF.PNTR SLIP TO LEFT IN BUFFER 
087C- 10 CF 1960 BPL .5 TRY AGAIN 
O87E- 30 E1 1990 . BMI .7 REST OF KEY BETTER BE WILD 
0880- BD 2010 WILD.CARD .AS -/=/ 
2030 KEY JAS -/Az= / 
20 0 # Jeena QE SSS SSS SSS Swe es2eereee 
2050 FNLIST .AS -/A SIMPLE KEY / 
2060 “AS -/NOT SUCH A SIMPLE KEY / 
2070 "AS -/NOT A SIMPLE KEY AT ALL / 
2 AS -/A SIMPLE KEY AFTER ALL / 


0 . 
2090 NAME.CNT ~EQ #-FNLIST/30 
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